home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / sharexe.zip / MAKEKIT.MAN < prev    next >
Text File  |  1988-02-21  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. MAKEKIT(1)          UNIX Programmer's Manual           MAKEKIT(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      makekit - split files up into shell archive packages
  10.  
  11. SYNOPSIS
  12.      makekit [ -e ] [ -h# ] [ -iname ] [ -k# ] [ -m ] [ -nname ]
  13.      [ -oname ] [ -p ] [ -s#[k] ] [ -ttext ] [ file...  ]
  14.  
  15. DESCRIPTION
  16.      Makekit reads a list of files and directories, determines
  17.      their sizes, and parcels them up into a series of shell
  18.      archives such that all the archives are of reasonable size.
  19.      It then invokes shar(1L) to actually create the archives.
  20.  
  21.      By default, no archive will be larger than about 50,000
  22.      bytes; this may be changed by using the ``-s'' option.  If
  23.      the number given with the ``-s'' option ends with the letter
  24.      ``k'' then the size is multiplied by 1024, otherwise it is
  25.      taken to be the desired maximum size, in bytes.  Each
  26.      archive will have a name that looks like Partnn, where
  27.      ``nn'' represents the two-digit sequence number (with lead-
  28.      ing zero if needed).  The leader part of the archive name
  29.      may be changed with the ``-n'' option.  The ``-n'' is also
  30.      useful when write permission to the directory being archive
  31.      is defined; e.g., ``-n/tmp/KERNEL.''
  32.  
  33.      Makekit reads its list of files on the command line, or
  34.      standard input if none are given.  It is also possible to
  35.      specify an input filename with the ``-i'' option.  The input
  36.      should contain a list of files, one to a line, to separate.
  37.      In addition, if each input line looks like this:
  38.           filename   whitespaces   optional-
  39.           digits   whitespaces   text
  40.      then makekit will ignore the spaces and digits, but remember
  41.      the text associated with each file, and output it with the
  42.      filename when generating the ``shipping manifest.'' Further,
  43.      the ``-h'' option may be given to have the program skip the
  44.      indicated number of lines in the input; this option is pro-
  45.      vided so that makekit can more easily re-parse the manifests
  46.      it has generated.
  47.  
  48.      The generated manifest will be sent to the standard output.
  49.      An alternate output file may be given by using the ``-o''
  50.      option; if the output file exists, makekit will try to
  51.      rename it with an extension of .BAK.  If the ``-o'' option
  52.      is used, makekit will add that name to the list of files to
  53.      be archived; the ``-e'' option may be given to exclude the
  54.      manifest from the list.
  55.  
  56.      The ``-m'' option is the same as given the options, ``-
  57.      iMANIFEST -oMANIFEST -h2.''
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Printed 2/21/88               LOCAL                             1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MAKEKIT(1)          UNIX Programmer's Manual           MAKEKIT(1)
  71.  
  72.  
  73.  
  74.      After partitioning the files and directories, makekit calls
  75.      shar with the proper options to generate archives in a
  76.      series.  Each resultant archive will, when executed, check
  77.      to see if all the parts are present.  By using the ``-t''
  78.      option, you can specify a line of starting instructions to
  79.      display to the recipient when all pieces have been unpacked.
  80.      See shar for more information on multi-part archives.  If
  81.      the ``-x'' option is used, shar is not called, but the mani-
  82.      fest is still created.
  83.  
  84.      Makekit normally reorders its input so that the archives are
  85.      as ``dense'' as possible, with the exception that direc-
  86.      tories are given priority over files, and a file named
  87.      README is the first of all.  The manifest is also sorted in
  88.      alphabetical order; this makes it easy to locate ``missing''
  89.      files when the distribution is a large one.  The ``-p''
  90.      option may be used to override both sortings, however, and
  91.      preserve the original order of the input list in generating
  92.      both the manifest, and the shell archives.
  93.  
  94. NOTES
  95.      Makekit tries to partition the files so that all directories
  96.      are in the first archive.  This usually means the first
  97.      archive must be the first one to be unpacked.
  98.  
  99. SEE ALSO
  100.      findsrc(1L), shar(1L)
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Printed 2/21/88               LOCAL                             2
  130.  
  131.  
  132.  
  133.